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INTRODUCING. ..... 


ilello and welcome to the first 
newsletter of SURF. I would like to 
start by apolozising for the delay in 
publishing this first issue and hope you 
feel it has been worta the wait. I would 


like to thanx Julian Vincent for 
stepping in and helpinz with the 
production of the newsletter. Without 
his nelp it would have been even later 


and considerably less well presented. 


We hope you are finding SPDOS a useful 
addition to your computer resources and 
loox forward to hearing from you and 
perhaps publisning your comments in 
future newsletters. We have included 
instructions for using the  MOREX/ 
ABBEYDALE printer software with tasword2 


and MASTERFILE. ommicalc2 is also easy 
to use vith this interface simply by 
loading and initialising the driver 


before loading omiicale itself. ve 
understand from our many members that 
SPDOS is compatible with most printer 
interfaces and will be happy to publish 
any instructions for other peripherals 
that you have working with SPDOS. We 
have also included a section on 
converting prosrams for use with SPDOS 
and would welcome contributions to this 
section in future newsletters. 


We have written a tape-disk program 
which can transfer programs up to 42 
kbytes onto a SPDUS disk. This package 
is still not quite complete but we hope 
to be offering it for sale in the next 
newsletter. To complement MASTERFILE we 
are able to offer a special version of 
"MEPRINT" waich you can order from us at 
"4.00 + VAT. Please allow 23 days for 
delivery. 


We have also found that many of you 
are Yaithful users of the MORYX/ 
ABBEYDALS printer interface. If you are 
still usinz the original software for 
this (identified as “Print 48" or "print 
16") you can purchase the new version 
(starts with a progran called "config" 
on the tape) fron us for 25.00 + VAT 
including p+p etc. 


A number of SURF members produce 
software in their own right and we hope 
to ve offering some of their products i 
future. 
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able to obtain a reasonable discount by 
ordering through ABBEYDALE DESIGNERS. 
This will probably not be the fastest 
service but if you are interested please 
write and tell us your requirements. We 
will then publish the prices we can 
obtain them for in the next newsletter. 


SPDOS is international. “e should 
like to welcome our members in other 
countries. There is a large contingent 
in Belgium but we also have members in 


Sweden, Germany, France, Spain and most 
European countries including Poland. 
SPDOS is also being exported to China 


and a special version ins been produced 
for the TIMEX 2063. This is being 
marketed in the U.S.A. by RAMEX 
INTERNATIONAL of Michigan and we already 
have some ney members using this 
version. 


I hope you find this newsletter useful 
and welcome any comments and would also 


welcome any letters or articles for 
inclusion in future editions. 

Dave Farmoorough 
-=== EDITOR'S RAMBLINGS == 


This isn't really an Editorial because 
Dave has written that. It's a sort of 
introduction, though, because I'm the 
guy who's putting this newsletter 
together. I asked Dave if I could do it 
because he had been so fantastically 
helpful with me and my problems getting 
a disc drive and power supply to worn, 
erasing all my discs and silly things 
like that. I used to think I was, ever 
so slightly, technologically minded. 
But I can easily live with SPDOS. It's 
not just that SPDOS is "user-friendly", 
Dave is as well!! I've been asked to 
inject 2 little reader-friendliness into 
SURF - after all, it's YOUR newsletter, 
so YOU press the buttons and say what 
YOU want to appear in it. Here are a 
few of your letters to date: 


Fran David Magnus, Cheshunt: 
- The FORMAT procedure does not work 
and I have nad to use "copysys" for all 
my discs. a 


Dave Farmborough replies: 

«sone of the first operations that the 
program “copysys" does is to use the 
FORMAT procedure from your system disc. 
he fact that vou have used "copyvsvs" 


deonstrates that the FORMAT overlay is 


OK. thing you have probably found 
that discs produced using just FORMAT 
will not allow CAT, MOVE and other 


communis that use overlays to work. it 
you use PORMAT on its own you will make 
a "data" disk and this is not usually 
convenient if you have only a single 
drive. We nornally recommend the use of 
"copysys" for all disks in this case. 
The advantage of a data disc if you nave 
more than one drive is a slight increase 
in capacity (10k) where the. operating 


system would have been recorded. You 
cua still use data disks but you must 


always put your system disk in the drive 


before using overlay commands - then 
force à prompt using the ";" option at 


the ends of such commands. 


--==3PDJ3 on the Buropean Continent==— 


from A. Siateciri, Warsaw: 

I am the happy owner of your Watfords 
Spectrum Dise Operating System and 
interested to know is it possible to be 
a member of your famous club, as Iam a 
citizen of Poland Socialist Country. I 
will be nappy to have an answer às soon 
as possible. 


from Marx Alcide, Belgiun: 


Feeling very lonely with my SPDOS 
interface - I think I am the only owner 
of the thing for miles around. I would 
lise to ask if it's possible to join 


your SURF club. Can L buy SPDOS-compat— 
ible software in Belgium or Holland? If 
not, can I buy it in Dover or Folkstone? 


..when this was being written there 
were two other SUR? members in Belgium! 
dave also says: information concerning 
any special software will be given in 
the newsletter and in general can be 


obtained by mail order fron the 
suppliers. For example, Hisoft has 
produced SPDOS versions of DEVPAC and 
PASCAL which can be obtained at normal 


retail prices direct from Hisoft. 


fron Mike Tooley, Weybridge: 

Since our last telephone conversation 
I have received the SPDOS package for 
review in Everyday Electronic (or 
Practical Electronics). I must say that 
I have found this to be an excellent 
"package" and certainly the best of - the 
diss filing systems that I have seen to 
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earned cash in order to keep it! 

What response has there been from 
software houses? Do you intend to 
produce any utilities to run with SPDOS 
(eg tape-to-disc transfer, disk editor, 
etc.)? 


. «replies Dave Farmborough - 

We are doing a number of program 
conversions including special versions 
of all the OCP programs. There is at 
least one software house intending to 
publish in SPDOS format. Most serious 
programs can be converted readily, such 
as Picturesque, the SOFTEK and = PSS 
compilers, Beta BASIC, two versions of 
FORTH and many of the graphics design 
programs. We have yet to find a program 
that cannot be converted to run with 
SPDOS. We shall be releasing SPDOS 
utilities and the first is likely to be 
a tape to disc program that I have been 
using for some months. The public forn 
of that program is virtually complete 
and will be released in the next few 
weeks. 


from Richard Parrant, llarlow: 

You may recall, Dave, that we 
discussed how large a program could be 
saved and loaded from disk. As Scrabble 
is the largest I have, I tried your 
technique of splitting the code and using 
the display file as a work area...and in 
it went! The block of code is 41136 
bytes long, starting at 24400 and going 
to 65535. I am sure that SPDOS opens a 
whole new world to Spectrum addicts. 
Soon I won't be able to tell the 
difference between my Spectrum and the 
16Mbyte NAS 9000 that we use at work!!! 


This newsletter will, we intend, be 
quarterly. Owing to the format we have 
chosen we can produce the newsletter 
only a few days after deciding what to 
put into it. This way we can keep you 
really up to date on all aspects of 
SPDOS. We shall also publish your 
advertisements FREE!! This will follow 
on the philosophy of the Spectrum and 
SPDOS - quality without cost. So let us 
kmow your wants, exchanges and extras, 
but remember that any software has 
either got to be your own or really 

second-hand and that you haven't 
retained a copy. Otherwise it will be 
"pirated" software subject to normal 
copyright laws. 
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~ MANIPULATION OF THE DIRECTORY/CATALOGUE 


The CAT command sends its output to 
stream 2 and has a fixed format which 
enables you to write your om utilities 
to extend the usefulness of SPDOS. An 
example is given below which allows you 
to erase selected files from a disk. 


10 PRINT #2: OPEN #2, 
20 INPUT "Purge drive 
CAT : PRINT a 

30 PRINT #4: CLOSE #2 
AO PRINT #4: OPEN #5, "cat": PRINT 2 

50 FOR b=1 TO 8: INPUT #5; LINE ad: NEXT 
b: REM step over heading 

60 INPUT #5; LINE a$ 


"cat": PRINT 2 
no? "ya: PRINT #4: 


70 IP CODE a$=0 THEN PRINT #4: CLOSE #53 


STOP 

80 PRINT "ERASE ";aS (13 TO LEN a$);"y/n 
Pr; INPUT b$ 

90 IP bS="y" OR b$="Y" THEN PRINT #4: ER 
ASE a$(18 TO LEN a$): GO TO 60 


MEMBERS! INTERESTS 


Theatre 
Real-time systems 
Domestic and Business applications 
Programming 
hotography 
Bridee (cards) 
> Aviation 
Shooting 
Educational programs 
Adventure ¿ames 
Criminology 
Statistics 
Questionnaires 
Computer control 
Data-logging 
Machine-code programming 
Football management 
Motorcycling 
Artificial intelligence 
LISP 


Amateur radio 
CAD for circuit design 
Music 


PEER 


SINGLE CHARACTER FILENAMES 


The DOS can load and run either BASIC or 
machine code programs which have been 
saved with a single character filename. 
This uses fewer keystrokes than normal ly 
required and allows extensions to BASIC 
to be made easily. 


The convention is as follows: 


a/ BASIC programs must be saved with a 
line number and a SINGLE CHARACTER 
filename: 


PRINT #4: SAVE "a" LINE 10 


hen to load and run your program simply 
key in: 


PRINT f4'a 


The use of a single quote character 
allows you to use the letters, numbers 
and symbols (.,:f?/etc) as filenames. 
You can also use keywords but your line 
must pass the Sinclair syntax tests. Tf 
the keyword is one normally entered from 
the K£ cursor mode the single quote must 
be replaced by ":" 


e.g. PRINT #4:SAVE "COPY" LINE 10 


and then load your program with: 
PRINT #4:COPY 


where in both cases COPY is the keyword. 
To enter this in the SAVE command use 
the following procedure: 


Key in PRINT /4:SAVE "":COPY then use 
the cursor key (CAPS SHIFT/5) to move 
back and delete the colon and one pair 
of inverted commas. Then step forward 
over the keyword, insert another pair of 
inverted commas and continue as normal. 


b/ Machine code programs can also be 
saved and loaded usinz the above 
technique and with tne same convention 
for filenames. When the program is 
loaded it will load into the same area 
from which it was saved and then jump to 
the first location. The command is 
parsed up to and including the character 
representing the filename but your 
program must continue parsing from that 
point if an error is to be avoided on 
return to BASIC. This technique enables 


you to devise or redefine commands and 
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eliminates the need for a USR call when 
running machine code. An example of a 
machine code overlay will be given in a 
future newsletter. 


PROBLEMS WITH "AUTO" 


If you have SPDOS version 1.1 you might 
experience problems when using the AUTO 
filename for BASIC programs. The 
Spectrua enters the AUTO-run program 
from K-mode (keyword) and as a result, 
although numbers and symbols are still 
interpreted cerrectly, letters produce 
the code for the appropriate keyword 
which of course is ignored by your INPUT 
routines. ‘This can be rectified by 
including the following at the beginning 
of the AUTO progran: 


POKE 25611,204 
wnich restores the normal 'L' cursor. 


This 'patch' will not be necessary in 
future releases of SPDOS. 


USING MiniDOS 


MiniDOS can come in very handy if your 


favourite programs conflict with the 
main DOS. The Picturesque Monitor 48 and 


Assembler 48 as well as the HISOFT 
Ultrakit fall into this category. 


Before loading MiniDOS, you mst CLEAR 
48999. After MiniDOS is in memory, you 
“must initialise it by means of a 
RANDOMISE USR 49644. This will normally 
produce the Abbeydale Copyright message 
and return to the BASIC command level. 
To stop it from exiting to BASIC and 
forcing it to continue with your 
program, make sure to POKE 49647,201 
BEFORE the USR call. 


MiniDOS needs an overall 4x (including 
its 0.5k buffer) so memory from 53100 
upwards is free. To ensure compatibility 
with future releases of MiniDOS which 
could well need more room, you should 
consider MiniDOS as ending at 53500. 


PROGRAM CONVERSION 


This section of the newsletter will 
provide information concerning the 
compatibility of most popular programs 
with SPDOS. You are invited to write to 
us with ideas, suggestions or requests 
and we will try to work out a solution 
or remedy! 


Let us consider BASIC programs first: 


In most cases, all you have to do is 


locate all occurrences of 'TOAD', 
'SAVE', 'MERGE' and 'VERIFY'. References 
to 'VERIFY' can be deleted while a 


'PRINT #4:' must be inserted before the 
others. 


Remember: a disk system expects 
filenames to be supplied explicitly. 
LOAD "" will not be accepted so you need 


to imow what you are loading. 


Another thing to have in mind is that 
the ordinary 'PRINT' statement after a 
SPDOS command will generate an error 
report unless it is preceded by a 
double colon (::) or a 'PRINT d' ie a 
drive specification. (See page 19 of 
your SPDOS manual) 


If you are using the main DOS you must 


change all 'CLEAR' statements above 
57855 to 'CLEAR 57855' and if this 
causes a ‘Out of memory' error when 


DIMensioning an array, try gradually to 
reduce the size of this array. If you 
discover a part of the BASIC program 
that is used only once (say, as soon as 
the program is first RUN) you could free 
some more space by deleting it using the 
SPDOS 'CLEAR' command. 


For machine-code programs you need to 
know the start address and the length. 
This can be found with a simple 
header-reader. If the code loads near 
the beginning of BASIC (near 23755) it 
will overwrite EDIT-LINE and other 
useful areas that the Spectrum sets up. 
If the length allows, load the code 
higher up in memory, maxing a note of 
the start address, and then save onto 
disk. If the code is loaded by a BASIC 
program make sure that you specify the 
real load address after the LOAD 
instruction. 


Some programs that are loaded near the 
BASIC area will work if loaded in the 
correct location after saving to disk as 
above. In some cases it is possible to 


ignore the BASIC loader and screen etc. 
. and just load the main code block. 


A number of programs might conflict with 
both the main DOS and miniDOS. If they 
do not load or save data from within the 
program you can load tnem lower down in 


menory, add a block-move routine and 
then save then to disk. When you load 
such a program from disk do a USR call 
to the block-move routine (which will 
overwrite tne DOS) and then jump to the 
real entry point. e.g. Suppose the game 


"SHOOT'EM" contains a machine-code 
section starting at 50000 and having a 
length of 15000 bytes. This means that 
the last byte is at 65000. For the DOS 
to load it from disx, the last byte must 
be loaded at 57855 and hence the first 
byte must be at 42855. To be on tne safe 


side CLEAR 39999 and LOAD "SHOOT'EMc" 
CODE 40000. The code will now end at 
55000. Let's assume that the BASIC 


loader runs the code from location 60000 
by means of a USR 60000 call then the 
following assembly language program must 
be added to che code: 


ORG 55001 

LD HL,55000 ¡Last byte 

LD BC,15000 ;Length 

LD DE,65000 ¿Real last 
byte 

LDDR “Block move 

JP 60000 ¡Start prog 


LDDR is used because the destination 
address is larger than the source 
address and there could be an overlap. 
the hex codes for this routine are: 
21,D8,D6,11,E3,FD,01,983,3A,ED,B8,C3,60, 


The decimal equivalents are: 
PEPA E ES Y is Des DECT 
184,195,96,254 


Simply poxe these decimal numbers into 
memory starting at 55001 and carrying on 
to 55014 and then: 

PRET? #4:SAVE "SHOOT'EMc"CODE 40000, 
15015 


When you load the code back, replace the 
BASIC loader call (USR 60000) with a USR 


55001 to run the block move routine 
first. 
If you have any comments on the 


routines in this newsletter or better 
versions of your own, don't forget to 
share them with the other members of 
SURF! 


CUSTOMISING MASTERFTLE FOR USE WITH 
THE ABBEYDALE/MOREX PRINTER INTERFACE 


These instructions will work for Version 
1 of the print driver software (PRINT 
48) and for Version 2 (supplied with 
"config"). For other interfaces the 
method will be similar providing that 
the driver software is as above and 
compatible with SPDOS. 


The method described is intended for 32 
character lines on the screen. If the 
microprint option is required then 
MFPRINT should be used . This must be 
the special SPDOS version as the tape 
version is not compatible. You can also 
use the screen dump method as described 
in 6 below. 


NEVER USE YOUR SPDOS MASTER DISK FOR 
MODIFICATIONS 


1/. Save the printer driver on the disk 
using the start and length values from 
the BASIC program provided with your 
printer software. If you have Version 1 


you must use the 48k program. For these 
instructions I shall use the filename 
"PME" but you can use another name of 


your own choice. 


2/. Replace the loading program "MFLOAD" 
with the following program: 


10 CLEAR 49647 :PRINT #4: LOAD "PMF" 
CODE: RANDOMISE USR 64974: REM this 
last address will be 64973 for Version 1 
20 PRINT #4: LOAD "MF" 


3/. Save the new loading program using: 
PRINT #4: SAVE "PFLOAD" LINE 10 
4/. Now load MASTERFILE by using: 
PRINT #4: LOAD "PFLOAD" 
5/. You must now break into MASTERFILE. 
(See MASTERFILE section of SPDOS manual 
page 5 "BASIC COMMAND MODE"). 


6/. Key in a replacement line for line 


4010 as follows: 


4010 FOR X=0 TO 25 : FOR Y=0 TO 31: 
LPRINT SCREENS (X,Y);: NEXT Y:LPRINT: 
NEXT X: PRINT: GO TO USR R 


(N.B. If you have a dot matrix printer 
with graphics capability you can obtain 
a gereen conv by replacing line 4010 


with the alternative line below which 
will also enabie microprint files to be 
reproduced. 


4010 RANDOMISE USR n: PRINT: GO TO USR R 


where n is the address of the 
appropriate routine for a single or 
double size copy.) 


7/. Resume MASTERFILE using GO TO 1 and 
make a new copy on the disk using option 
"y" from the main mem and the filename 
"Mp", 


A special SPDOS version of MFPRINT is 
available from ABBSYDALE DESIGNERS for 
£4.00 + VAT including p+p. 


CUSTOMISING TASWORD TWO FOR 
THE MOREX/ABBEYDALE VERSION 2 DRIVER 


You must incorporate the printer 
software into tasword. Load the version 
2 configured driver. This is the ver- 
sion produced as the final step when 
ruming "config", the menu-driven 
program that customises the driver to 
your requirements. Ensure that tokens 
are printed by keying in: 


POKE 64422,1 


Save this customised software by keying 
in: 
+. SAVE "printcode"CODE 64420,621 

Load tasword and enter BASIC by pressing 
the STOP control key and then the "bp" 
key. Execute the following four 
statements taking care to type the 
correct numbers: 


POKE 59818, 164 
POKE 59819,251 
POKE 59852, 164 
POKE 59833, 251 


Then incorporate your customised printer 
program using: 


LOAD "printcode"CODE 57856 


RUN tasword 2 and use the define 
graphics/printer facility (obtained by 
pressing STOP and then the "g" key) to 


arand fer tha 51 1 ruin s4ntarfararnr mamada 


Interface control code 1: O 


Interface control code 2: O 
Interface control code 3: O 
Interface control code 4: 64974 
Then specify the code ror carriage 


return and linefeed on your printer (13 
and O or 15 and 10. Experiment before 
you make a backup) 


At this stage the graphics can be 
programmed according to the various 
control codes of your printer (option 
"g" of the mem). 


Finally, save the customised program by 
using option "t" (save tasword). 


N.B. The configured printer driver 
program can be saved and loaded from 
disk by preceding the save and load 
commands with: 


PRINT #4: 


ENVOI 


Well, that's it for the first SURF 
newsletter - at last it has SURFaced. I 
cannot have a SURFeit of such reading - 
there is never SURFicient of it......... 
Don't forget to write to  ABBEYDALE 
DESIGNERS, PO Box 124, Reading, UK, RG4 
OLF, if you have an idea, complaint, 
advertisement, request, etc. Are there 
any extra tricks you'd like SPDOS to be 
able to perform? I'd like a program to 
enable me to riffle through the CATalog 
of a disc and choose which program to 
load with a single key-stroke, rather 
like the ERASE program at the start of 
this newsletter. I haven't played with 
the idea yet but it should be a doddle, 
so long as I remember to CLOSE #5. Dave 
has mentioned other little tricks which 
SPDOS is already set up to perform - the 
SURF newsletter will contain details of 
these routines as Dave rediscovers them. 
++... YOu may also be interested in the 
idea of making SPDOS compatible with the 
VTX5000. Well, it's under way. The 
ideal would be to download the driver 
software from disc rather than the ROM 
in the VTX5000. Then all the advantages 
and flexibility of disks would be 
available - storage of frames, simple 
preparation of messages off-line, etc. 
Not to mention the reduction in wear and 
tear on the edge connectors. 


